Skip to main content

App Configuration Guide

This guide explains the key settings used to configure the client app.

🌐 URLs​

  • Primary: https://localhost:60230/ This is the main ClientHub API endpoint. It provides data to the client app during normal operation.
  • Training: https://test.bliksundhf.no/clienthub/ This is used when the app switches to training mode. Users can activate this mode by clicking the "..." button in the app.

⏱ Lock Timer​

  • Value: 15 The app will auto-lock after 15 minutes of inactivity to help protect sensitive data.

🔐 Encrypt Database​

  • Enabled: true The local SQLite database used by the client app will be encrypted for added security.

🌍 Language (Locale)​

  • Current: en The app supports multiple languages, including:
    • English (UK)
    • Danish
    • Norwegian
    • German
    • Swedish

🔐 Authentication​

The app uses OIDC (OpenID Connect) for authentication. It supports two modes:

  • Client-side (WebView): If ServerSideOIDCAuthentication is set to false, the app handles login inside the client app using WebView.
  • Server-side (via ClientHub): If ServerSideOIDCAuthentication is true, the app authenticates through the ClientHub API.

Key Settings:​

  • ServerSideOIDCAuthentication: false Controls where authentication happens (client or server).
  • ClientId: 4a821d50-11a1-483f-8782-e865ab3033a1 This is the Application (client) ID from Microsoft Entra (Azure AD).
  • Authority: https://login.microsoftonline.com/73935988-7e75-46c2-8cc6-d2d91985f67b/v2.0 This is the login URL used for authentication.
  • Scope: openid profile email This must include openid (for sign-in) and any other scopes needed for consent.
  • Claims:
    • User ID: preferred_username
    • Name: name
    • Organization: extn.OrganizationIdentification
  • UseWebView2Login: true Enables login using WebView2 inside the app.
  • EnableAzureSSOExperience: false Set to true to allow SSO using the Windows account.
  • AdditionalLoginParameters: Can be used to customize login (e.g., &prompt=select_account).

📝 Logging​

  • Minimum Level: Warning Only warnings and more severe messages will be logged. This helps reduce noise and keeps logs focused on important issues.

🧪 Debugging​

  • EnableWebViewDebugging: true Allows debugging of WebView content during development.

    Examples​

WebView based OIDC login​

{
  "Version": 2,
  "Url": {
    "Primary": "https://ewa.releases.bliksundhf.no/main/clienthub/",
    "Training": "https://test.bliksundhf.no/clienthub/"
  },
  "Dataset": "Azure",
  "LockTimer": 15,
  "EncryptDatabase": true,
  "Locale": "en",
  "Authentication": {
    "ServerSideOIDCAuthentication": false,
    "OidcClientOptions": {
      "ClientId": "4a821d50-11a1-483f-8782-e865ab3033a1",
      "ClientSecret": null,
      "Authority": "https://login.microsoftonline.com/73935988-7e75-46c2-8cc6-d2d91985f67b/v2.0",
      "Scope": "openid profile api://4a821d50-11a1-483f-8782-e865ab3033a1/Client"
    },
    "UserIdClaimType": "preferred_username",
    "NameClaimType": "name",
    "OrganizationClaimType": "extn.OrganizationIdentification",
    "CurrentOrganizationId": null,
    "UseWebView2Login": true,
    "EnableAzureSSOExperience_Comment": "Set to true to enable SSO experience using the logged in-to Windows account",
    "EnableAzureSSOExperience": false,
    "AdditionalLoginParameters_Comment": "Often used when EnableSSOExperience is set to true to configure the login experience. Examples: &prompt=select_account, &prompt=none, &prompt=login",
    "AdditionalLoginParameters": ""
  },
  "Logging": {
    "MinimumLevel": "Warning"
  },
  "EnableWebViewDebugging": true
}

Browser based OIDC login​

{
  "Version": 2,
  "Url": {
    "Primary": "https://ewa.releases.bliksundhf.no/main/clienthub/",
    "Training": "https://test.bliksundhf.no/clienthub/"
  },
  "Dataset": "Azure",
  "LockTimer": 15,
  "EncryptDatabase": true,
  "Locale": "en",
  "Authentication": {
    "ServerSideOIDCAuthentication": true,
    "AdditionalLoginParameters_Comment": "Often used when EnableSSOExperience is set to true to configure the login experience. Examples: &prompt=select_account, &prompt=none, &prompt=login",
    "AdditionalLoginParameters": ""
  },
  "Logging": {
    "MinimumLevel": "Warning"
  },
  "EnableWebViewDebugging": true
}